home *** CD-ROM | disk | FTP | other *** search
/ BCI NET / BCI NET Dec 94.iso / archives / programming / source / hpcd2ppm06.lha / hpcdtoppm.0.6 / hpcdtoppm.manpage < prev    next >
Encoding:
Text File  |  1994-07-24  |  14.0 KB  |  397 lines
  1.  
  2.  
  3.  
  4. hpcdtoppm(1L)     Misc. Reference Manual Pages      hpcdtoppm(1L)
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      hpcdtoppm - convert a Photo-CD file into a  portable  bitmap
  10.      file
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      hhhhppppccccddddttttooooppppppppmmmm _i_n_f_i_l_e [----aaaa] [{----CCCC|----0000|----OOOOvvvveeeerrrrvvvviiiieeeewwww _f_i_l_e _o_p_t] [----cccc0000]  [ ----
  14.      cccc----] [----cccc++++] [----ccccrrrroooopppp] [----dddd] [----ddddppppiiii _f] [----eeeeppppssss] [----eeeeppppssssdddd] [----eeeeppppssssgggg] [----ffffaaaakkkk
  15.      _s_c_a_l_e] [----hhhhoooorrrriiii] [----iiii] [----llll] [----mmmm] [----nnnn] [----ppppbbbb _p_o_s] [---- ppppggggmmmm]  [ ---- pppphhhh
  16.      _h_e_i_g_h_t]  [ ---- ppppllll  _p_o_s] [----ppppoooossss] [----ppppppppmmmm] [----ppppssss] [----ppppssssdddd] [----ppppssssgggg] [----ppppwwww
  17.      _w_i_d_t_h] [----rrrr] [----rrrreeeepppp] [----SSSS _l_o_n_g _s_h_o_r_t] [----ssss] [----vvvveeeerrrrtttt] [----xxxx] [---- yyyycccccccc]
  18.      [ ----1111|----BBBBaaaasssseeee////11116666 |-_1_2_8_x_1_9_2] [----2222|----BBBBaaaasssseeee////4444 |-_2_5_6_x_3_8_4] [----3333|----BBBBaaaasssseeee |-
  19.      _5_1_2_x_7_6_8] [----4444|----4444BBBBaaaasssseeee |-_1_0_2_4_x_1_5_3_6] [----5555|----11116666BBBBaaaasssseeee |-_2_0_4_8_x_3_0_7_2] [----
  20.      6666|----66664444BBBBaaaasssseeee |-_4_0_9_6_x_6_1_4_4] [_o_u_t_f_i_l_e]
  21.  
  22. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  23.      This program accepts Photo-CD image or  overview  file  data
  24.      from the specified input file, _i_n_f_i_l_e (or, if the resolution
  25.      is lower than 64Base and the file argument is specified as ----
  26.      ,  from  standard  input), and writes either Portable Bitmap
  27.      Format or POSTSCRIPT to the specified  output  file  (or  to
  28.      standard output if no file is specified).
  29.  
  30.      On   a   standard   Photo-CD,   image   files   appear    in
  31.      _p_h_o_t_o__c_d/_i_m_a_g_e_s,  where  they  appear in files with names of
  32.      the form img_n_n_n_n._p_c_d, where _n_n_n_n is a  4-digit-number.   The
  33.      overview file appears in _p_h_o_t_o__c_d/_o_v_e_r_v_i_e_w._p_c_d.
  34.  
  35.      Photo-CD images are stored using  as  many  as  6  different
  36.      resolutions:
  37.                Format              Resolution
  38.                ------              ----------
  39.                64Base              4096x6144 (ProPhotoCD only)
  40.                16Base              2048x3072
  41.                4Base               1024x1536
  42.                Base                512x768
  43.                Base/4              256x384
  44.                Base/16             128x192
  45.  
  46.      The overview file employs Base/16 format.
  47.  
  48. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  49.      Invoking _h_p_c_d_t_o_p_p_m without  arguments  produces  a  list  of
  50.      default  values.   Note  that  you  can supply only one size
  51.      option.
  52.  
  53.      ----aaaa    Automatically determine image orientation (this option
  54.           is experimental, and does not work for overview files).
  55.  
  56.      {----CCCC | ----0000 | ----OOOOvvvveeeerrrrvvvviiiieeeewwww | ----OOOO } _f_i_l_e _o_p_t
  57.           Extract all images from an overview file.   The  manda-
  58.           tory  _f_i_l_e  argument  is the name of a _p_p_m file; output
  59.           files are named  _f_i_l_e_n_n_n_n,  where  _n_n_n_n  is  a  4-digit
  60.  
  61.  
  62.  
  63. Sun Microsystems    Last change: 3 March 1994                   1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. hpcdtoppm(1L)     Misc. Reference Manual Pages      hpcdtoppm(1L)
  71.  
  72.  
  73.  
  74.           number.   Overview images are extracted in their origi-
  75.           nal Base/16 format.  The value of  _o_p_t  determines  the
  76.           orientation  of  the  contact  sheet  image; recognized
  77.           values are:
  78.  
  79.           nnnn    Do not rotate the image.
  80.  
  81.           llll    Rotate  the  picture  counter-clockwise  (portrait
  82.                mode).
  83.  
  84.           rrrr    Rotate the picture clockwise (portrait mode).
  85.  
  86.      ----cccc0000   Do not correct (brighten or darken) the image.
  87.  
  88.      ----cccc----   Darken the image.
  89.  
  90.      ----cccc++++   Brighten the image.
  91.  
  92.      ----ccccrrrroooopppp
  93.           Cut off the black frame which sometimes appears at  the
  94.           image borders.
  95.  
  96.      ----dddd    Show only the decompressed difference rather than  the
  97.           complete  image  (applicable  only  to 4Base and 16Base
  98.           images).
  99.  
  100.      ----ddddppppiiii rrrreeeessss
  101.           Set  the  printer  resolution  to  _r_e_s   for   dithered
  102.           POSTSCRIPT images.
  103.  
  104.      ----eeeeppppssss  Write a RGB Encapsulated POSTSCRIPT color image.
  105.  
  106.      ----eeeeppppssssdddd
  107.           Write a Floyd-Steinberg dithered image in  Encapsulated
  108.           POSTSCRIPT.
  109.  
  110.      ----eeeeppppssssgggg
  111.           Write a grayscale image in Encapsulated POSTSCRIPT.
  112.  
  113.      ----ffffaaaakkkk ssssccccaaaalllleeee
  114.           Set the scaling factor for dithered  POSTSCRIPT  images
  115.           to _s_c_a_l_e.
  116.  
  117.      ----hhhhoooorrrriiii
  118.           Flip the image horizontally.
  119.  
  120.      ----iiii    Send information from an image file header to standard
  121.           error.
  122.  
  123.      ----llll    Rotate the picture counter-clockwise (portrait mode).
  124.  
  125.      ---- mmmm    Write  messages  about  the  phases  of  decoding  to
  126.  
  127.  
  128.  
  129. Sun Microsystems    Last change: 3 March 1994                   2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. hpcdtoppm(1L)     Misc. Reference Manual Pages      hpcdtoppm(1L)
  137.  
  138.  
  139.  
  140.           standard error.
  141.  
  142.      ----nnnn    Do not rotate the image.
  143.  
  144.      ----ppppbbbb ppppoooossss
  145.           Set the bottom position of the POSTSCRIPT image to _p_o_s.
  146.  
  147.      ----ppppggggmmmm  Write a _p_g_m (grayscale) image.
  148.  
  149.      ----pppphhhh hhhheeeeiiiigggghhhhtttt
  150.           Set the height of the POSTSCRIPT image to _h_e_i_g_h_t.
  151.  
  152.      ----ppppllll ppppoooossss
  153.           Set the leftmost position of the  POSTSCRIPT  image  to
  154.           _p_o_s.
  155.  
  156.      ----ppppoooossss  Print the relative starting position of the  data  for
  157.           the current resolution.
  158.  
  159.      ----ppppppppmmmm  Write a _p_p_m RGB (color) image.
  160.  
  161.      ----ppppssss   Write a RGB POSTSCRIPT color image.
  162.  
  163.      ----ppppssssdddd  Write a Floyd-Steinberg dithered image in POSTSCRIPT.
  164.  
  165.      ----ppppssssgggg  Write a POSTSCRIPT grayscale image.
  166.  
  167.      ----ppppwwww wwwwiiiiddddtttthhhh
  168.           Set the width of the POSTSCRIPT image to _w_i_d_t_h.
  169.  
  170.      ----rrrr    Rotate the picture clockwise (portrait mode).
  171.  
  172.      ----rrrreeeepppp  Try to jump over reading errors in the Huffman code.
  173.  
  174.      ----SSSS lllloooonnnngggg sssshhhhoooorrrrtttt
  175.           Cut out a subrectangle with boundaries defined  by  the
  176.           values:
  177.  
  178.           _l_o_n_g For the longer side of the image.
  179.  
  180.           _s_h_o_r_t
  181.                For the shorter side of the image.
  182.  
  183.           where _l_o_n_g and _s_h_o_r_t take one of two forms:
  184.  
  185.           aaaa----bbbb   Cut from position _a to position _b.
  186.  
  187.           aaaa++++bbbb  Starting at offset _a, cut a length of _b.
  188.  
  189.           and where _a and  _b  are  either  integers  representing
  190.           pixel  locations,  or  floating  point  values over the
  191.           range [0.0 ... 1.0], representing the fraction  of  the
  192.  
  193.  
  194.  
  195. Sun Microsystems    Last change: 3 March 1994                   3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. hpcdtoppm(1L)     Misc. Reference Manual Pages      hpcdtoppm(1L)
  203.  
  204.  
  205.  
  206.           length of a side.
  207.  
  208.      ----ssss    Apply a simple sharpness operator  to  the  luminosity
  209.           channel.
  210.  
  211.      ----vvvveeeerrrrtttt
  212.           Flip the image vertically.
  213.  
  214.      ----xxxx   Overskip Mode (applicable to Base/16, Base/4, Base  and
  215.           4Base).   In  Photo-CD images the luminosity channel is
  216.           stored in full resolution, the two  chromaticity  chan-
  217.           nels  are stored in half resolution only and have to be
  218.           interpolated.  In Overskip Mode, the chromaticity chan-
  219.           nels of the next higher resolution are taken instead of
  220.           interpolating.  To see the difference, generate one _p_p_m
  221.           with  and  one _p_p_m without this flag.  Use _p_n_m_a_r_i_t_h(1L)
  222.           to generate the difference image of these  two  images.
  223.           Call  _p_p_m_h_i_s_t(1L)  for  this difference or show it with
  224.           _x_v(1L) (push the HHHHiiiissssttttEEEEqqqq button in the color editor).
  225.  
  226.      ----yyyycccccccc  Write the image in _p_p_m YCC format.
  227.  
  228.      ----1111|----BBBBaaaasssseeee////11116666|----111122228888xxxx111199992222
  229.           Extract the Base/16 image.
  230.  
  231.      ----2222 |||| ----BBBBaaaasssseeee////4444 |||| ----222255556666xxxx333388884444
  232.           Extract the Base/4 image.
  233.  
  234.      ----3333 |||| ----BBBBaaaasssseeee |||| ----555511112222xxxx777766668888
  235.           Extract the Base image.
  236.  
  237.      ----4444 |||| ----4444BBBBaaaasssseeee |||| ----1111000022224444xxxx1111555533336666
  238.           Extract the 4Base image.
  239.  
  240.      ----5555 |||| ----11116666BBBBaaaasssseeee |||| ----2222000044448888xxxx3333000077772222
  241.           Extract the 16Base image.
  242.  
  243.      ----6666 |||| ----66664444BBBBaaaasssseeee |||| ----4444000099996666xxxx6666111144444444
  244.           Extract  the  64Base  image.  This  resolution  can  be
  245.           extracted  from ProPhotoCD images only. The path of the
  246.           64Base extension files is derived from the path to  the
  247.           image file. This means that it doesn't work on stdin an
  248.           the directory structure must be the very same as on the
  249.           ProPhotoCD.
  250.  
  251. PPPPOOOOSSSSTTTTSSSSCCCCRRRRIIIIPPPPTTTT OOOOUUUUTTTTPPPPUUUUTTTT
  252.      For POSTSCRIPT output (options ----ppppssss, ----eeeeppppssss, ----ppppssssgggg, ----eeeeppppssssgggg, ----ppppssssdddd,
  253.       ---- eeeeppppssssgggg) you can define both the resolution and placement of
  254.      the image.  Both size and position are specified  in  points
  255.      (1/72 inch).
  256.  
  257.  
  258.  
  259.  
  260.  
  261. Sun Microsystems    Last change: 3 March 1994                   4
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. hpcdtoppm(1L)     Misc. Reference Manual Pages      hpcdtoppm(1L)
  269.  
  270.  
  271.  
  272.      The position of the image (where the origin is assumed to be
  273.      at the lower left corner of the page) is controlled by the ----
  274.      ppppllll and ----ppppbbbb options (applicable at all resolutions).
  275.  
  276.      The size of color and grayscale images is changed with the ----
  277.      ppppwwww  and   ----pppphhhh options.  Every image pixel is mapped onto one
  278.      POSTSCRIPT pixel.
  279.  
  280.      There are three modes of control for dithered POSTSCRIPT:
  281.  
  282.      Image size
  283.           (----ppppwwww and ----pppphhhh)
  284.  
  285.      Printer resolution
  286.           (----ddddppppiiii)
  287.  
  288.      Scaling factor
  289.           (----ffffaaaakkkk)
  290.  
  291.      These three factors are interdependent, hence no  more  then
  292.      two  can  be specified simultaneously.  Using ----ddddppppiiii and the ----
  293.      ppppwwww/----pppphhhh options together often yields pleasing results.  Even
  294.      using  the  default  values  for  these options will produce
  295.      results differing from those obtained  without  use  of  the
  296.      options.
  297.  
  298. BBBBUUUUGGGGSSSS
  299.      The program ignores read protection.
  300.  
  301.      The ----iiii option is not working correctly.
  302.  
  303.      Available information obout the Photo-CD  format  is  vague;
  304.      this  program was developed by trial-and-error after staring
  305.      at hex-dumps.  Please send bugs reports and patches  to  the
  306.      author.
  307.  
  308. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  309.      pnmarith(1L),    ppm(5L),     ppmhist(1L),     ppmquant(1L),
  310.      ppmtopgm(1L), ppmtorgb3(1L), xv(1L)
  311.  
  312. VVVVEEEERRRRSSSSIIIIOOOONNNN
  313.      The name _h_p_c_d_t_o_p_p_m stands for "Hadmut's pcdtoppm,"  to  make
  314.      it  distinguishable in the event that someone else is build-
  315.      ing a similar application and naming it _p_c_d_t_o_p_p_m.   This  is
  316.      version 0.6.
  317.  
  318. AAAAUUUUTTTTHHHHOOOORRRR
  319.      Copyright  (c)  1992,   1993,   1994   by   Hadmut   Danisch
  320.      (danisch@ira.uka.de).   This  software is not public domain.
  321.      Permission to use and distribute this software and its docu-
  322.      mentation  for  noncommercial  use and without fee is hereby
  323.      granted, provided that the above copyright notice appear  in
  324.  
  325.  
  326.  
  327. Sun Microsystems    Last change: 3 March 1994                   5
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. hpcdtoppm(1L)     Misc. Reference Manual Pages      hpcdtoppm(1L)
  335.  
  336.  
  337.  
  338.      all copies and that both that copyright notice and this per-
  339.      mission notice appear  in  supporting  documentation.   This
  340.      software  may  not be sold or used for profit-making activi-
  341.      ties.
  342.  
  343.      Manual  page  extensively  modified  by  R.  P.  C.  Rodgers
  344.      (rodgers@nlm.nih.gov).
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393. Sun Microsystems    Last change: 3 March 1994                   6
  394.  
  395.  
  396.  
  397.